Jump To:
Technical Q&As: Legacy Technologies
As Carbon and Mac OS X evolve, the APIs and technologies they encompass change to meet the needs of users and developers. As part of this evolution, less efficient features, interfaces, and programming techniques are deprecated or retired in favor of newer ones. Apple makes these changes only when deemed absolutely necessary. Apple identifies deprecated API in header files and the ADC Reference Library. Availability macros (defined in /usr/include/AvailabilityMacros.h) further help developers find deprecated interfaces in their source code. Comments in header files and corresponding reference documentation provide information about recommended replacements. Legacy documents help developers understand legacy technologies, identify replacements, and update their products to run on current Apple platforms.

View all Carbon Technical Q&As.
Document Descriptions
On Off
Display

Sort by
Title
Sort by
Legacy Status
Sorted by
Date
Additional URL Access Error Codes (HTML) ()
NW66.
Unsupported 2002-12-18
URL Access and the Missing Progress Dialog (HTML) ()
QA1140: Explains a known bug in URL Access related to progress dialogs.
Deprecated 2002-09-23
Setting request headers in URL Access (HTML) ()
QA1073: Explains how to work around a bug in URL Access when setting request headers.
Deprecated 2002-09-10
The intermittent behavior of SetDialogItemText (HTML)
QA1082: Explains why SetDialogItemText may seem to not work correctly if you have embedding turned on.
Deprecated 2001-10-30
How to use URL Access with proxy servers (HTML)
QA1074: Explains how to use URL Access with proxy servers.
Deprecated 2001-10-02
Resource chain corruption when using Navigation Services dialogs and Carbon Events (HTML)
QA1066.
Unsupported 2001-08-21
Targeting DebuggingCarbonLib asserts (HTML)
QA1033: Describes how to focus DebuggingCarbonLib asserts to a single application.
Deprecated 2001-05-04
Finding the VM Backing Store (HTML) ()
ME07.
Unsupported 2001-03-30
Find Documents Folder (HTML) ()
OPS17.
Unsupported 2001-03-26
BowelsOfTheMemoryManager (aka YourHeapIsProbablyCorrupt) (HTML) ()
ME05: What the symbol BowelsoftheMemoryManager means and the most probable cause of this symbol in MacsBug.
Deprecated 2001-02-01
GetPortBitMapForCopyBits (HTML) ()
QD61: Describes the proper usage of GetPortBitMapForCopyBits.
Deprecated 2000-11-08
Receiving UDP Broadcasts While Sending from a Secondary Address (HTML)
NW67.
Unsupported 2000-05-08
CloseDialog and 'ictb's (HTML)
TB66.
Unsupported 2000-01-18
Raw IP and Open Transport 2.5.x (HTML)
NW63: Discusses Open Transport 2.5's change to the behavior of raw IP endpoints with IP_HDRINCL set.
Deprecated 1999-10-25
Detecting specific ROM-in-RAM Mac (HTML) ()
HW49: Identifying a Mac by name ("iMac"), and better alternatives for determining specific features ("has Firewire").
Deprecated 1999-10-05
Synchronizing Sounds to Video (HTML) ()
SND19: Enabling regular sound callbacks under Mac OS 9 and Sound Manager 4.0.
Deprecated 1999-10-05
Synchronous SysBeep (HTML) ()
SND18: Obtaining a synchronous SysBeep with Sound Manager 3.1.
Deprecated 1999-10-05
MACE Restrictions (HTML) ()
SND16: MACE algorithms only support the compression of 8-bit offset binary sound.
Deprecated 1999-06-08
Reserved Key Combinations (HTML) ()
TB41.
Unsupported 1999-05-17
Setting a Control's Variant Field (HTML) ()
TB63: Details how to change the variant of a custom control after creating the control.
Deprecated 1999-05-03
Setting the Background Color of a Control (HTML) ()
TB62.
Unsupported 1999-05-03
Localized Versions of Appearance SDK (HTML) ()
TB61.
Unsupported 1999-04-12
fBroadCastAddr Always Zero (HTML) ()
NW58: Explains why the fBroadcastAddr field may be zero after a call to OTInetGetInterfaceInfo and includes the workaround.
Deprecated 1999-03-08
Navigation Services Versions (HTML) ()
TB38.
Unsupported 1999-03-08
Non-consensual Contextual Menu Manager Plug-ins (HTML) ()
TB59.
Unsupported 1999-02-08
Adding Color Icons to Menu Items (HTML) ()
TB48.
Unsupported 1998-12-22
Calling GetMenu Redundantly (HTML) ()
TB45.
Unsupported 1998-12-22
Desk Accessory Menus (HTML) ()
TB51.
Unsupported 1998-12-22
Maximum Number of Menu Items (HTML) ()
TB57.
Unsupported 1998-12-22
Menu Definition Drawing Dimmed Items (HTML) ()
TB50.
Unsupported 1998-12-22
Moving the Menu Bar (HTML) ()
TB54: Describes how to move the menubar to another Macintosh Display and why this move is unadvisable.
Deprecated 1998-12-22
System Menu IDs (HTML) ()
TB46.
Unsupported 1998-12-22
Tear-off Menus (HTML) ()
TB55.
Unsupported 1998-12-22
Unpopped Popup Menus and Mac OS 8.5 (HTML) ()
TB44.
Unsupported 1998-12-22
grayishTextOr and Mac OS 8.5 (HTML) ()
QD59: Explains why text drawn using TextMode(grayishTextOr) is never drawn; provides a workaround.
Deprecated 1998-12-07
PBXGetVolInfo Glue (HTML) ()
FL07.
Unsupported 1998-07-30
Navigation Services and memFullErr (HTML) ()
TB40.
Unsupported 1998-07-06
Capturing Speech Manager Output (HTML) ()
SND15: Capturing the output from the Speech Synthesis Manager to a file.
Deprecated 1998-05-18
Using OpenTransport With CFM-68K (HTML) ()
NW19.
Unsupported 1998-05-04
Recording Compressed Sounds (HTML) ()
SND14: Sound Manager and sound input driver compression options are limited to allow interrupt time recording.
Deprecated 1998-04-12
siMonitorSource Selector (HTML) ()
SND13: Using the sound output siMonitorAvailable, and siMonitorSource selectors.
Deprecated 1998-04-12
siOSTypeInput Selectors (HTML) ()
SND12: The use of siOSTypeInputSource, and siOSTypeInputAvailable selectors and extracting the siOSTypeInputAvailable OSTypes returned.
Deprecated 1998-04-12
The Improper use of FSClose (HTML) ()
TB36.
Unsupported 1998-02-10
Parsing the PICT File Format (HTML) ()
QD56: Explains where to find information on the PICT file format and warns against parsing a PICT file.
Deprecated 1998-02-10
Setting Audio Input Gain (HTML) ()
SND11: Setting audio input gain under Mac OS 8.1.
Deprecated 1998-02-10
Selecting a specific sound input source (HTML) ()
SND10: Using the sound input driver to select specific sound input sources.
Deprecated 1998-01-16
siOSTypeInputAvailable Format (HTML) ()
SND09: The format of the data returned by the siOSTypeInputAvailable selector is SoundInfoList.
Deprecated 1998-01-16
Obtaining Standard Icons (HTML)
TB35.
Unsupported 1997-12-23
Creating Gray Scaled Images > 8 bits (HTML) ()
QD51: Shows how to create gray-scaled images at resolutions greater than 8 bits for display.
Deprecated 1997-11-17
Receiving UDP Broadcasts (HTML) ()
NW53: Explains why UDP endpoints may never receive UDP broadcast messages.
Deprecated 1997-11-17
White Backgrounds for Dialog editText Items (HTML) ()
TB34.
Unsupported 1997-10-13
How to use the OT modem script engine (HTML) ()
NW50: Shows how to use the Open Transport modem script engine.
Deprecated 1997-07-11
68K Open Transport Code on Power Macintoshes (HTML)
NW48: Explains why running Open Transport 68K code on a PowerPC may not always work.
Deprecated 1997-03-14
Errors on Symbol Names Longer than 64 Characters (HTML) ()
TB33.
Unsupported 1997-01-31
Calling TrackDrag with the Event Record's 'where' Field Expressed in Local Coordinates (HTML)
TB29.
Unsupported 1996-11-27
Drag Manager and windowKind 20 (HTML) ()
TB28.
Unsupported 1996-11-27
The InterfaceLibSys7.additions Stub Library (HTML) ()
PLAT23.
Unsupported 1996-11-14
Using 'ictb' to Change Edit Fields (HTML) ()
TB24.
Unsupported 1996-10-25
Limitations to Menu Item Size under Menu Manager (HTML) ()
TB23.
Unsupported 1996-09-27
New MacApp Release Approach (HTML)
PLAT25.
Unsupported 1996-08-21
Server Endpoint 'qlen' Limit (HTML) ()
NW38: Tells how to determine the maximum 'qlen' value which limits the number of supported handoff endpoints.
Deprecated 1996-08-21
Calling CloseOpenTransport When Writing an App (HTML) ()
NW36: Identifies a bug in Open Transport 1.1 which means your application must CloseOpenTransport before quitting.
Deprecated 1996-07-03
OTScheduleSystemTask Cleanup (HTML) ()
NW37: States the proper way to clean up any pending system tasks scheduled with OTScheduleSystemTask.
Deprecated 1996-07-03
Making Input Gain Setting Changes (HTML) ()
SND01: Changing the input gain setting on older Power Macs before recording.
Deprecated 1996-06-01
NewRoutineDescriptor & Porting 68K code to PPC (HTML) ()
PPCSYS08.
Unsupported 1996-06-01
siActive Channels Unsupported on Some Power Macs (HTML) ()
SND03: siActive Channels is unsupported on some older PowerMacs (siUnknownInfoType returned by SPBGetDeviceInfo).
Deprecated 1996-06-01
Aborting a OTConnect in Progress (HTML)
NW29: Describes the proper way to abort OTConnect, and why after calling OTSndDisconnect you may receive "kOTOutStateErr".
Deprecated 1996-05-14
Getting Started with Network Programming (HTML)
NW32.
Unsupported 1996-05-14
How PBDTGetAPPL Chooses Which Copy of an App to Launch (HTML) ()
TB19: Explains how PBDTGetAppl() chooses which application copy to launch, and how to deal with the trash.
Deprecated 1996-05-14
Synchronous TCP OTConnect Client Call Completes Before Server Responds (HTML) ()
NW24: Explains why an OTConnect call will complete before the server responds.
Deprecated 1996-05-14
TCP Option Sizes (HTML)
NW27: Tells where to get more information on TCP Option sizes and setting TCP Options.
Deprecated 1996-05-14
Error -3168 (kOTStateChangeErr) and Handoff Endpoints (HTML) ()
NW22: Explains why a kOTStateChangeErr -3168 occurs when there is a handoff endpoint involved.
Deprecated 1996-04-08
Closing the Connection: OpenTransport (HTML) ()
NW20: Describes an orderly disconnect situation in Open Transport between two nodes.
Deprecated 1996-03-04
Locating a Font's Home File (HTML) ()
TB18: Lists the steps necessary to find the home file of a given font.
Deprecated 1996-02-15
Using qd and QDGlobals (HTML) ()
QD40: Why a sample program compiled with SC may give the link error: undefined entry qd. Provides a solution.
Deprecated 1996-02-09
Using Temporary Memory with OpenPicture (HTML)
QD20: Provides several techniques of causing OpenPicture to allocate temporary memory for a picture handle.
Deprecated 1996-02-01
Determining if a Drive is a Network Volume (HTML)
FL01.
Unsupported 1995-11-01
Hidden Volumes in HFS (HTML)
FL03.
Unsupported 1995-11-01
Necessity of Calling PrJobDialog (HTML)
QD31.
Unsupported 1995-11-01
Resolving Aliases Asynchronously (HTML)
FL06.
Unsupported 1995-11-01
Searching Directories with PBCatSearch (HTML)
FL05.
Unsupported 1995-11-01
Standard File Package (HTML)
FL04.
Unsupported 1995-11-01
Placing a Foreground Task into the Background (HTML)
PS04.
Unsupported 1995-09-27
Converting RGB Colors to a Palette Index (HTML)
QD21: Explains how to convert RGB colors into the palette index created by an application.
Deprecated 1995-09-15
Error -151 and NewGWorld (HTML)
QD18: Explains what the error code -151 means when in NewGWorld.
Deprecated 1995-09-15
Incorrect Inside Macintosh Volume V documentation (HTML)
QD15: Identifies incorrect documentation in Inside Macintosh Volume V regarding the formats of PnPixPat and BkPixPat opcodes.
Deprecated 1995-09-15
PCI Throughput Issues (HTML)
DV20.
Unsupported 1995-09-15
Problem Getting PICTS to Display in Correct Colors (HTML)
QD24: Using a custom color table to get PICTs to display with the right colors in an offscreen GWorld.
Deprecated 1995-09-15
Problem with PaintRgn on 256-color Screens (HTML)
QD23: PaintRgn with RGBForeColor and transfer mode addOver doesn't return color to original on 256-color-screens.
Deprecated 1995-09-15
Problems Creating a Mask for a Picture (HTML)
QD27: Demonstrates creating a mask where the mask is 0 for pure white pixels and 1 everywhere else.
Deprecated 1995-09-15
Spooling in or out of CompressPicture or CompressImage (HTML)
QD17: Recommends alternatives to spooling the results of CompressPicture or CompressImage to or from disk.
Deprecated 1995-09-15
Window Manager and EraseRect (HTML)
QD26: Why WindowManager causes a flicker using EraseRect and provides a solution for this problem.
Deprecated 1995-09-15
Determining Whether a Device Supports Asynchronous I/O (HTML)
DV05.
Unsupported 1995-07-01
Macintosh Quadra 700 and 900 SCSI Chip Anomaly and Fix (HTML)
DV08.
Unsupported 1995-07-01
Deleting a Resource Fork (HTML)
OPS04.
Unsupported 1995-06-01
A5 World (HTML)
PPCSYS02.
Unsupported 1995-05-01
Calling the Resource Manager from a Patch (HTML)
TB02.
Unsupported 1995-05-01
Closing PPC ports (HTML)
IC01.
Unsupported 1995-05-01
Color Animated Cursors (HTML)
TB03.
Unsupported 1995-05-01
ColorPicker.h and ColorSync 2.0 (HTML)
CS01.
Unsupported 1995-05-01
CTB & the AppleTalk ADSP Tool (HTML)
NW03.
Unsupported 1995-05-01
FAT Code Resources (HTML)
PPCSYS04.
Unsupported 1995-05-01
HMShowBalloon styled TEHandle limit and Workaround (HTML)
TB07.
Unsupported 1995-05-01
Kanji and Special Text-Processing (HTML)
TX01.
Unsupported 1995-05-01
Localization Problems with Apps for Japan (HTML)
TX02.
Unsupported 1995-05-01
MacTCP and UDP Performance (HTML)
NW07.
Unsupported 1995-05-01
Native App Slowdown (HTML)
PPCSYS05.
Unsupported 1995-05-01
noResponseErr from PPC Toolbox (HTML)
IC02.
Unsupported 1995-05-01
PowerPC & Writing Info to the Data Fork (HTML)
PPCSYS07.
Unsupported 1995-05-01
Print Scaling (HTML)
QD05.
Unsupported 1995-05-01
Process Manager (HTML)
PS02.
Unsupported 1995-05-01
Sharing Globals Between Apps & Code Fragment Manager (HTML)
IC03.
Unsupported 1995-05-01
Using PrGeneral() to Download Fonts (HTML)
QD06.
Unsupported 1995-05-01
Workaround for Converting Lower to Uppercase Characters while Keeping Diacritical Marks (HTML)
TX04.
Unsupported 1995-05-01
xSYM files (HTML)
PPCSYS06.
Unsupported 1995-05-01